AUGMENT QUICK REFERENCE 


HOW TO READ THIS CARD 


This card lists the commands and features most commonly used in 
display mode. (For others, use Help; see ONLINE HELP.) All 
commands are Base subsystem commands unless noted otherwise. 


color Blue indicates what you enter. Black boldface 
indicates what the system displays. 


UPPERCASE Uppercase words represent choices. The most 
common choices are listed below the command or 
under SPECIAL TERMS. For others, type ? at the 


prompt. 
Initial Words in blue with the first letter capitalized are 
Uppercase command words; type the first letter of the word or 


type a space and then the first letter or letters. 
AUGMENT fills out the word. 


<> denote special characters you type (see SPECIAL 
CHARACTERS) 


<CTRL- > surrounding a character indicates a control character; 
hold down the CTRL key while typing that character 


/ separates choices 


fed enclose options you ask for by typing <OPT> 


STARTING A WORK SESSION 


Use the NAMEs, PASSWORDs, and NUMBER you are given. 
Connecting to the host computer through TYMNET: 


please type your terminal identifier a 
please log in: NAME;PASSWORD<RET> 


Connecting to the host computer through ARPANET: 


@i<SP>25<RET> 
<CTRL-Y>o<SP>NUMBER<RET> 


Logging into the host computer and entering AUGMENT: 


@log<SP>NAME<SP>PASSWORD<SP><RET> 
@augment<RET> 


ENDING A WORK SESSION 


Logout Job OK/TYPEIN from the Base subsystem 


After logging out, ARPANET users close the connection with 
<CTRL-Y>c<RET>. 


VIEWSPECS 


Blank lines Blank lines between statements on 
Blank lines between statements off 


Statement numbers Statement numbers/SIDs on 
and SIDs Statement numbers/SIDs off 
Statement numbers/SIDs right 
Statement numbers/SIDs left 
Show SIDs, not statement numbers 
Show statement numbers, not SIDs 
Statement names Show statement names 
Don’t show statement names 
Statement signatures Show statement signatures 
Don’t show statement signatures 
Level and line Show first level only 
clipping Show one level more 


Show one level less 

Show all levels 

Show levels down to level of statement to 
be at top of file window 

Show first lines only 

Show one line more 

Show one line less 

Show all lines 

Show one level and one line only 

Show all levels and all lines 


Structure clipping Show branch only 
Show all branches 
Show plex only 


Content filtering Filter statements 
Don’t filter statements 
Show next filtered statement 


Level indenting Level indenting on 
Level indenting off 
With viewspec | or g, offsets indenting to 
level of statement at top of file window; 
turn off with viewspec h 


Frozen statements Show frozen statements 
Don’t show frozen statements 


Screen recreation Put viewspecs into effect 
Recreate display (with viewspecs in effect) 
Recreate window after each change 
Defer recreating window 
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ONLINE HELP 
@tutor<RET> instead of entering AUGMENT; teaches you how to 
use basic AUGMENT capabilities 
The following are available in all AUGMENT subsystems. 
? at any prompt, lists your current alternatives 


<HELP> at any prompt, displays information about the 
command as far as you have given it 


Help OK displays information about the current subsystem 


Help TYPEIN displays information about the term or command 
you give for TYPEIN 


After typing <HELP> or starting a Help command, your choices are: 


TYPEIN another term or command or a menu item number 
€ to go back to a previous Help view 
<CD> to return to your work in progress 

Jump (to) Locator OK a guide to AUGMENT documentation 


WRITING 


Create File (to be named) CONTENT 


Insert Statement (to follow statement at) LOCATION 
TYPEIN/ [ADDRESS] 


Insert Statement (to follow statement at) LOCATION LEVADJ 
CONTENT 


<INS> INSERTSPEC INSERTSPEC ... <CD> 
INSERTSPEC = TYPEIN or [ADDRESS] or LEVADJ CONTENT 


READING AND CHANGING VIEWS 


The Jump commands are available in all subsystems. 

Jump (to) <MARK> VIEWSPECS 

Jump (to) Link CONTENT 

Jump (to) Origin (of file) LOCATION VIEWSPECS 

Jump (to) Next/Back/Down/Up (from) LOCATION VIEWSPECS 

Jump (to) Successor/Predecessor (of) LOCATION VIEWSPECS 

Jump (to) Head/Tail (of plex at) LOCATION VIEWSPECS 

Jump (to) End (of) File/Branch/Plex (at) LOCATION VIEWSPECS 

Jump (to) Content/Word First/Next <RC>/CONTENT VIEWSPECS 
<TAB> command repeats a previous word or content search. 

Jump (to) Name First/Next/Any CONTENT VIEWSPECS 


Set Name (delimiters in) STRUCTURE (left delimiter to be) 
CONTENT (right delimiter to be) CONTENT 


Reset Name (delimiters in) STRUCTURE OK 

Show Name (delimiters for statement at) LOCATION 
Jump (to) Return OK 

Jump (to) Return File OK 


Set Viewspecs VIEWSPECS 


With a mouse, you can set lowercase viewspecs by pressing the left 
and middle mouse buttons while typing the viewspecs, and uppercase 
viewspecs by pressing all mouse buttons while typing the viewspecs 
(in lowercase). Include viewspec f or F. 


Reset Viewspecs (to defaults) OK 


EDITING 


Insert Front (of statement at) LOCATION (the text) CONTENT 
Insert STRING (to follow STRING at) LOCATION CONTENT 


Insert STRUCTURE (to follow statement at) LOCATION 
TYPEIN/ [ADDRESS] 


Insert STRUCTURE (to follow statement at) LOCATION LEVADJ 
CONTENT 


Delete STRING (at) LOCATION 


Delete [(filtered) FVIEWSPECS] STRUCTURE (at) LOCATION 
(really?) OK 


Move STRING (from) LOCATION/ [TYPEIN] (to follow STRING 
at) LOCATION 


Move [(filtered) FVIEWSPECS] STRUCTURE (from) LOCATION/ 
[TYPEIN] (to follow statement at) LOCATION LEVADJ 


Copy STRING (from) LOCATION/ [TYPEIN] (to follow STRING 
at) LOCATION 


Copy [(filtered) FVIEWSPECS] STRUCTURE (from) LOCATION/ 
(TYPEIN] (to follow statement at) LOCATION LEVADJ 


Replace STRING/STRUCTURE (at) LOCATION (by) CONTENT 


Replace All (occurrences in) [(filtered) FVIEWSPECS] 
STRUCTURE (at) LOCATION (of old) STRING CONTENT (by new 
STRING) CONTENT OK/ALSO 


ALSO = Also (of old STRING) STRING (by new STRING) 
CONTENT OK/ALSO 


Transpose STRING/STRUCTURE (at) LOCATION (and) LOCATION 


Force (case of) STRING/STRUCTURE (at) LOCATION CASEMODE 
OK 


Force (case of) [CASEMODE (for)] STRING/STRUCTURE (at) 
LOCATION 


CASEMODE = Lower or Upper or First (letter upper) 


Append Statement (at) LOCATION/ [TYPEIN] (to) LOCATION (join 
with) OK/TYPEIN/ [LOCATION] 


Append All (statements in) [(filtered) FVIEWSPECS] STRUCTURE 
(at) LOCATION (join with) OK/TYPEIN/ [LOCATION] 


Break Statement (after visible at) LOCATION LEVADJ 

Reverse Group/Plex (at) LOCATION 

Sort Branch/Group/Plex (at) LOCATION OK for alphabetic sort 
Sort Branch/Group/Plex (at) LOCATION SORTTYPE 


SORTTYPE = Date (and time) OK/SORTTYPE 
or Reverse OK/SORTTYPE 


SPECIAL DISPLAY FEATURES 


Break Window Horizontally/Vertically (at) <MARK> OK 


Break Window Horizontally/Vertically (at) Center (of window) 
<MARK> OK 


Commands affect the window containing the cursor at the final 
<OK>. To offset indenting in a narrow window, set viewspecs 1Q. 


Enlarge Window <MARK> (to) <MARK> OK 
Delete Window <MARK> (enlarging window at) <MARK> OK 


Freeze [(filtered) FVIEWSPECS] STRUCTURE (at) LOCATION 
(with viewspecs) VIEWSPECS 


Include o in VIEWSPECS or set viewspec o afterwards. 
Thaw All (frozen statements) OK 
Thaw STRUCTURE (at) LOCATION 
The following are available on the AUGMENT 1200 terminal. 


SCREEN SAVE key saves current screen image; SCREEN SWITCH 
key displays image saved with SCREEN SAVE key. 


To double the width of the file window: 
@widescreen<RET> at the Executive @ 


Then push in switch 4 on display’s front panel, press LOCAL 
RESET key, and enter AUGMENT. Move cursor to edge of screen 
to display beyond edge. To return to normal width, Quit from 
AUGMENT, push out switch 4, press LOCAL RESET, and reenter 
AUGMENT. Useroption for display right margin must be set to 
160. For details, Jump (to) Locator to find documentation. 


PRINTING 
Print [(printing view) VIEWSPECS] FSTRUCTURE (on device) 
OK/DEVICETYPE (specifications:) OK /DEVICESPECS 


Print Sequential (file named) CONTENT (on device) 
OK/DEVICETYPE (specifications:) OK/DEVICESPECS 


Set Print (default device for session to) DEVICETYPE OK 


DEVICETYPE = Workstation (printer) 
or Lineprinter not for Print Sequential 
or Terminal not for Print Sequential 


DEVICESPECS = 
Copies CONTENT OK/DEVICESPECS not for Terminal 
or Wait (at page break) OK/DEVICESPECS not for Lineprinter 
or Quickformat OK/DEVICESPECS not for Print Sequential 


If Quickformat is not requested, output is formatted through the 
Output Processor. 


Start Workstation (printer) OK 


Stop Workstation (printer) WHEN (use START command to 
resume printing) OK 


WHEN = Immediately or End (of) File/Page 


FILE HANDLING 


Update (file) OK (new version) OK 
Update (file) New/Old (version) OK 
Update (file) Compact (new version) OK 
Update (file) Renamed CONTENT 
Delete File (named) CONTENT (really?) OK 
Undelete File (named) CONTENT 
Delete Modifications (to file) FILESPEC (really?) OK 
Undelete Modifications (to file) FILESPEC (really?) OK 
Check File (structure for internal consistency for file) FILESPEC 
Show Status (for file) FILESPEC 

FILESPEC = OK or TYPEIN or [LOCATION] 
Move File (named) CONTENT (to a file named) CONTENT 
Rename (file named) CONTENT (to be named) CONTENT 


Copy File (named) CONTENT (to a new file to be named) 
CONTENT 


Create Augment (structure from sequential file named) CONTENT 
(to follow statement at) LOCATION LEVADJ (using) SEQTYPE OK 


SEQTYPE = One/Two (<RET>s to end statement) 
or Two (<RET>s to end statement) Justified (delete 
extra <SP>) 


Create Sequential SEQFILE (from) FSTRUCTURE [(force upper 
case)] VIEWSPECS 


SEQFILE = File (named) CONTENT 
or Appending (to file named) CONTENT 


DIRECTORY HANDLING 


Connect (to) Directory (named) TYPEIN/ [LOCATION] (password) 
TYPEIN/ [ADDRESS] /OK 


Connect (to) Directory (named) OK (login directory) OK 


Trim (files in) Directory (named) DIRSPEC (to keep number of 
versions) CONTENT 


Expunge (deleted files in) Directory (named) DIRSPEC 
Show Disk (space for) Directory (named) DIRSPEC 
Show Directory (named) DIRSPEC OK/DIRTYPE 


Copy Directory (mamed) DIRSPEC (to follow statement at) 
LOCATION LEVADJ OK/DIRTYPE 


DIRSPEC = OK (connected directory) or TYPEIN 
or [LOCATION] 


DIRTYPE = No Version (numbers) OK/DIRTYPE 
or Size (in pages) OK/DIRTYPE 
or Date (of) Creation/Read/Write OK/DIRTYPE 
or Last (writer) OK/DIRTYPE 
or Deleted (files only) OK/DIRTYPE 
or Everything OK/DIRTYPE 
or For (file) CONTENT OK/DIRTYPE 


PROMPTS 


Prompts are uppercase letters, followed by a colon (:), telling you 
what you can do next in a command. Slash (/) separates choices. 
Square brackets [ ] enclose options you can ask for by typing 
<OPT>. The letters and what they stand for are listed below. (See 
SPECIAL CHARACTERS or SPECIAL TERMS for definitions.) 


A ADDRESS OPT <OPT> 

Cc Command word RC <RC> 

L LEVADJ T TYPEIN 

M <MARK> v VIEWSPECS 

OK <OK> Y/N y or <OK> for yes; n for no 


SPECIAL CHARACTERS 


Parentheses enclose equivalent control character or mouse button 
combination. e = button pressed, o = button not pressed. 


<BC> BACKSPACE CHARACTER: Erases the previous 
character or command step. (<CTRL-A> or eoo) 

<BW> BACKSPACE WORD: Erases the previous word. 
(<CTRL-W> or eeo) 

<CD> COMMAND DELETE: Cancels the current command. 


(<CTRL-X> or oeo) 


<ESC> ESCAPE: Fills out file names and directory names. 
(e0e) 


<HELP> Displays information about the current command; see 
ONLINE HELP. (<CTRL-Q>) 


<INS> INSERT: Lets you continually insert statements until 
you type <CD>; see WRITING. (<CTRL-E>) 


<LIT> LITERAL: Used in TYPEIN to precede a character that 
otherwise would have a special effect (such as ? at a 
prompt). (<CTRL-V>) 


<MARK> The process of pointing to a particular character on the 
screen and typing <OK>. 


<NULL> Specifies "nothing" when typed for CONTENT. 
(<CTRL-N>) 


<OK> Terminates part or all of an AUGMENT command. At 
the end of a command, you may type <INS> or <RC> 
in place of <OK>. (<CTRL-D> or ooe) 


<OPT> OPTION: Asks for an option in a command. 
(<CTRL-U>) 


<RC> REPEAT COMMAND: Repeats the last command 
continually until you type <CD>. Also used to repeat 
the text from a previous content or word search. 
(<CTRL-B> or oee) 


<RET> RETURN: Terminates part or all of an Executive 
command; forces a new line in AUGMENT TYPEIN. 
(<CTRL-M>) 


<TAB> Repeats a previous character, word, or content search. 
Also used for tabulation in TYPEIN. (<CTRL-I>) 


<SP> SPACE: Typed by pressing the space bar. 


SPECIAL TERMS 


ADDRESS Type an address, ending with <OK>. (See LINKS 
AND ADDRESSES.) 


CONTENT <MARK>/TYPEIN/ [ADDRESS]. If at the end of a 
command, <MARK> must be followed by <OK>. 
For Text, Phrase, or Group, two <MARK>s or 
ADDRESSes are needed. 


FSTRUCTURE STRUCTURE (at) LOCATION or Rest (of file) or 
File (named) CONTENT 


FVIEWSPECS Type level clipping or content filtering viewspec 
characters, ending with <OK>. (See VIEWSPECS.) 


LEVADJ Type level—adjustment characters (u for up, d for 
down), ending with <OK> or <SP>, or type <OK> 
or <SP> for same level. 


LOCATION <MARK>/ADDRESS. If at the end of a command, 
<MARK> must be followed by <OK>. For Text, 
Phrase, or Group, two <MARK>s or ADDRESSes 


are needed. 

OK Type <OK>. 

STRING Character/ Word/Text/Phrase/ Visible/Invisible/ 
Number/ Link/ Directive 

STRUCTURE = Statement/Branch/Group/Plex 

TYPEIN Type a series of characters, ending with <OK>. 


Context may require special TYPEIN, such as a link 
or a file name. 


VIEWSPECS Type viewspec characters, ending with <OK>, or 
just <OK> for no change. (See VIEWSPECS.) 


IN CASE OF TROUBLE 


If what you see on your screen looks wrong, do a local reset (press 
LOCAL RESET key or whatever is appropriate for your terminal) so 
terminal will redisplay or set viewspec F so AUGMENT will 
redisplay. 


If nothing seems to be happening, type <CTRL-T>; if you get no 
response, reconnect to the host computer and do @where 
NAMEKRET>. If Where lists your job, attach to it. (See the lesson 
"Starting and Ending an AUGMENT Work Session".) 


If you make a serious mistake while editing, you can copy from the 
previous version of the file or use Delete Modifications. 


If you can’t modify a file because it is already being modified by 
you, Quit and do @where NAME<RET>. If Where lists two jobs, do 
@logout<RET> and attach to the other job; otherwise, try 
@pop<RET> to get back to an earlier AUGMENT session. 


If you can’t update a file you modified in another directory, try 
connecting to the directory and then updating. 


If a message from Check File or any other command reports "Bad 
file", ask Help about the term "bad". (See ONLINE HELP.) 


For other assistance, contact your AUGMENT representative. 


CONTENT FILTERING 


Set Content (pattern to be) CONTENT 


To display filtered statements, set viewspec i or k. To edit or 
freeze filtered statements, use i in the [(filtered) FVIEWSPECS] 
option of the editing or Freeze command. 


Show Content (pattern currently in force) OK 


UTILITY COMMANDS 


Process (commands from) STRUCTURE (at) LOCATION 
Show Changes (to system) OK 
Show Version (of current AUGMENT system) OK 


MOVING AROUND BETWEEN SUBSYSTEMS 


These commands are available in all subsystems. 


Goto (subsystem) SUBSYSTEM/ [(subsystem name) CONTENT] OK 


Execute (command in) SUBSYSTEM/ [(subsystem name) 
CONTENT] 


SUBSYSTEM = Programs or Exec or Base 
or a previously loaded subsystem 


Quit OK 


CREATING AND EDITING TABLES 
The following are Table subsystem commands. Use Help in Table 
for additional commands and information. (See ONLINE HELP.) 


Insert Header (below) LOCATION (with number of columns) 
CONTENT (of widths) CONTENT 


Insert Row (after) LOCATION (with) CONTENT (justified) 
OK/JUST 


Separate entries with semicolon (;) or <TAB>. 


Insert Blank Column (to follow) LOCATION (with width) 
CONTENT 


Insert Blank Group (of rows after) LOCATION (number of rows) 
CONTENT 


Replace Entry/Row/Column (at) LOCATION (by) CONTENT 
(justified) OK/JUST 


Justify Entry/Row/Column (at) LOCATION (justified) OK/JUST 


JUST = Left OK or Right OK or Center OK 
or Two (places to right) OK 


Total Row/Column (of numbers at) LOCATION (enter result .as) 
RESULT 


RESULT = Entry (at) LOCATION or Status OK 
or Visible (after visible at) LOCATION 


Fillout Row/Table (at) LOCATION 


LINKS AND ADDRESSES 


A "link" is <ADDRESS:VIEWSPECS> 


You may omit the angle brackets < > when you type a link ina 
command. Parentheses ( ) as well as angle brackets can delimit a 
link. 


ADDRESS = FILEADDRESS for origin statement of file 
or INFILEADDRESS for location in current file 
or FILEADDRESS INFILEADDRESS 
or omit entirely for current location 


FILEADDRESS = FILENAME, at current site and directory 
or DIRECTORY,FILENAME, at current site 
or SITE,DIRECTORY,FILENAME, 


Note that every form of FILEADDRESS ends with a comma. 


FILENAME = NAME 
or NAME.EXTENSION 
or NAME.EXTENSION;VERSION 


<ESC> fills out file names and directory names. 


INFILEADDRESS is one or more of the elements below, separated by 
<SP>. <SP> is not required if the next element begins with 
punctuation. Use Help to get information about any of these 
elements (by typing its name) or about other elements (by typing 
"INFILEADDRESS"). (See ONLINE HELP.) 


Element Name Example 

STATEMENTNUMBER 1a2b 

SID 012 

STATEMENTNAME statementname 

NEXTNAME *statementname 

BRANCHNAME Istatementname 

CHARACTERSEARCH  ’c 

CONTENTSEARCH "text" 

WORDSEARCH "word"=w 

POSITION n next statement 
u statement up a level 
.e end of branch 
t tail of plex 
.2b two statements back 
.ds successor of statement down a level 
l1 location pointed to by embedded link 
r return to previous location in file 
xf return to previous file 


STRINGPOSITION last character of statement 


+ 
oO 


